home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Utilities / SortIcons / SortIcons.readme < prev    next >
Text File  |  2000-05-21  |  5KB  |  144 lines
  1.  
  2.  
  3. *****************************************************
  4. *                                                   *
  5. *  SortIcons.rexx 1.2   (c) 2000 Christoph Gutjahr  *
  6. *                                                   *
  7. *****************************************************
  8.  
  9.  
  10. ------------------------------
  11. |  COPYRIGHT AND DISCLAIMER  |
  12. ------------------------------
  13.  
  14.  This program is FREEWARE. It may be freely distributed in any way as
  15.  long as:
  16.  
  17.  - the two program files ("SortIcons.rexx" and "SorterStarter.rexx") and this
  18.    text file remain unaltered and are distributed together.
  19.  
  20.  - It is not used as part of a commercial product without my express
  21.    permission.
  22.  
  23.  Use this at your own risk. No warranties of any kind are made as to the
  24.  functionality of this program.
  25.  
  26. ------------------------------
  27. |        REQUIREMENTS        |
  28. ------------------------------
  29.  
  30.  Any Amiga computer with at least OS 3.5
  31.  
  32. ------------------------------
  33. |        DESCRIPTION         |
  34. ------------------------------
  35.  
  36.  This program sorts the icons on the Workbench "Root" window. A grid is
  37.  calculated, each icon is then moved to its nearest Grid position. You can
  38.  specify a place for both "Tool"- and "Disk"-Icons (left, right, top or
  39.  bottom border of the screen).
  40.  
  41.  You can specify if "App-" and "Drawer"-Icons should be ignored or treated
  42.  as "Tool"- or "Disk"-Icons.
  43.  
  44.  After running the script, you can sort your icons (swap the positions of
  45.  two icons etc.) manually and re-run the script to reposition the icons at
  46.  the calculated grid.
  47.  
  48.  It's a bit hard to explain, just try it out! (It's quite similar to a
  49.  WIN9x-Desktop's sort function, just better.. :)
  50.  
  51. ------------------------------
  52. |        INSTALLATION        |
  53. ------------------------------
  54.  
  55.  1. Make sure that your ARexx-Server is running (see final chapter - "The
  56.     ARexx-Server" - if you don't know what I'm talking about)
  57.  
  58.  2. Copy the script "SortIcons.rexx" to your REXX: drawer.
  59.  
  60.  3. There are three ways to start this script:
  61.  
  62.     - Install the brilliant "T.H.E." Package. This is the recommended
  63.       method, as T.H.E. will give you many other useful functions as well
  64.       as an easy way to make use of this script.
  65.  
  66.     - Copy the script "SorterStarter.rexx" (along with its Icon!) to your
  67.       "WBstartup"-drawer. This will add a new menu item to Workbench's
  68.       "Tools"-Menu named "SortIcons".
  69.  
  70.     - run it from the shell whenever you want to sort your icons.
  71.  
  72. ------------------------------
  73. |           USAGE            |
  74. ------------------------------
  75.  
  76.  The script can then be started with:
  77.  
  78.    SYS:Rexxc/rx SortIcons.rexx
  79.  
  80.  The program understands some arguments (these arguments are optional).
  81.  if you are using "T.H.E" or "SorterStarter.rexx" you have to edit
  82.  these files to add/remove arguments):
  83.  
  84.    Sorticons.rexx TOOL=L/R/T/B/I DISK=L/R/T/B/I APPICON=T/D DRAWER=T/D
  85.  
  86.    TOOL=L/R/T/B/I: Where to put "TOOL"-Icons. They can be put to the left/
  87.                    right/top/bottom border of the screen, or they can be
  88.                    ignored ("I"). Default: TOOL=R
  89.  
  90.    DISK=L/R/T/B/I: Where to put "DISK"-Icons. They can be put to the left/
  91.                    right/top/bottom border of the screen, or they can be
  92.                    ignored ("I"). Default: DISK=L
  93.  
  94.    APPICON=T/D:    How to treat "App"-Icons. They can be treated as "Tool"-
  95.                    or "Disk"-Icons. If this argument is missing, they are
  96.                    ignored (not sorted at all).
  97.  
  98.    DRAWER=T/D:     How to treat "Drawer"-Icons. They can be treated as
  99.                    "Tool"- or "Disk"-Icons. If this argument is missing,
  100.                    they are ignored (not sorted at all).
  101.  
  102.  As long as the script is working, you can't access Workbench. When the
  103.  script is finished, a requester will pop up, asking you if the icon
  104.  positions shall be saved to disk.
  105.  
  106. ------------------------------
  107. |         THANK YOUS         |
  108. ------------------------------
  109.  
  110.  The grid-concept was thought up by Soren Forsberg. He allowed me to use
  111.  parts of his code (thanks!)
  112.  
  113.  Thanks to Nils Goers for suggestions, error corrections and for T.H.E.
  114.  
  115. ------------------------------
  116. |           AUTHOR           |
  117. ------------------------------
  118.  
  119.  Christoph Gutjahr
  120.  Hermannstr. 41
  121.  12049 Berlin
  122.  Germany
  123.  
  124.  Korodny@gmx.net
  125.  
  126. ------------------------------
  127. |      THE AREXX SERVER      |
  128. ------------------------------
  129.  
  130.  To run ARexx-programs such as "SortIcons.rexx", the ARexx-Server must be
  131.  active. This can be achieved by different methods:
  132.  
  133.  - Double click on the "Rexxmast" Icon in your "SYS:System/" drawer. This
  134.    will activate Rexxmast immidiately.
  135.  
  136.  - move the "Rexxmast" Icon to your "SYS:Wbstartup" drawer or add the line
  137.  
  138.      RUN >NIL: SYS:System/Rexxmast
  139.  
  140.    to your Startup-sequence. This will make the ARexx-Server active when
  141.    your machine is booting. ARexx won't eat up mach memory or
  142.    CPU-Ressources, so this is the recommended method.
  143.  
  144.